home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / fbsubtexload.z / fbsubtexload
Encoding:
Text File  |  2002-10-03  |  3.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffbbbbssssuuuubbbbtttteeeexxxxllllooooaaaadddd((((3333GGGG))))                                              ffffbbbbssssuuuubbbbtttteeeexxxxllllooooaaaadddd((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffbbbbssssuuuubbbbtttteeeexxxxllllooooaaaadddd - load part or all of a texture defined with TX_FASTDEFINE
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd ffffbbbbssssuuuubbbbtttteeeexxxxllllooooaaaadddd((((lllloooonnnngggg xxxx,,,, lllloooonnnngggg yyyy,,,, lllloooonnnngggg ttttaaaarrrrggggeeeetttt,,,, lllloooonnnngggg iiiidddd,,,, ffffllllooooaaaatttt ssss0000,,,, ffffllllooooaaaatttt ssss1111,,,, ffffllllooooaaaatttt tttt0000,,,, ffffllllooooaaaatttt tttt1111,,,, uuuunnnnssssiiiiggggnnnneeeedddd lllloooonnnngggg ffffllllaaaaggggssss))))
  13.  
  14. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  15.      _x   is the window-relative starting x coordinate of the rectangle in the
  16.          framebuffer that is being loaded into texture memory.
  17.  
  18.      _y   is the window-relative starting y coordinate of the rectangle in the
  19.          framebuffer that is being loaded into texture memory.
  20.  
  21.      _t_a_r_g_e_t
  22.          is the texture target to which the texture we are loading is bound.
  23.  
  24.      _i_d  is the id of the texture we are loading.
  25.  
  26.      _s_0  is the starting S coordinate of the subtexture to load.
  27.  
  28.      _s_1  is the ending S coordinate of the subtexture to load.
  29.  
  30.      _t_0  is the starting T coordinate of the subtexture to load.
  31.  
  32.      _t_1  is the ending T coordinate of the subtexture to load.
  33.  
  34.      _f_l_a_g_s
  35.          is a special modifier.
  36.  
  37. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.      ffffbbbbssssuuuubbbbtttteeeexxxxllllooooaaaadddd loads some or all of a texture that is currently allocated
  39.      space in texture memory by copying a rectangle from the framebuffer using
  40.      the current readsource and readcomponent values.
  41.  
  42.      The transfer uses the scale and bias settings in effect at the time of
  43.      the texdef2d if TX_EXTERNAL_FORMAT, TX_PIXMODE was specified in the
  44.      properties.
  45.  
  46.      The values s0,s1,t0,t1 are mapped to texel values by
  47.      start_s_texel = s0*texture_width;
  48.      start_t_texel = t0*texture_height;
  49.      end_s_texel   = s1*texture_width - 1;
  50.      end_t_texel   = t1*texture_height - 1;
  51.  
  52.      s0,s1,t0,t1 should fall on texels that are a multiple of 32, i.e. for a
  53.      texture that is 256x128, s0,s1 can be
  54.      0,.125,.25..375,.5,.625,.750,.875,1.0, while t0,t1 can be
  55.      0.,.25,.50.,75.,1.0. Results are undefined for any other values.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffbbbbssssuuuubbbbtttteeeexxxxllllooooaaaadddd((((3333GGGG))))                                              ffffbbbbssssuuuubbbbtttteeeexxxxllllooooaaaadddd((((3333GGGG))))
  71.  
  72.  
  73.  
  74. SEE ALSO
  75.      texdef2d,subtexload,readsource,readcomponent
  76.  
  77. NNNNOOOOTTTTEEEESSSS
  78.      ffffbbbbssssuuuubbbbtttteeeexxxxllllooooaaaadddd is supported only on RealityEngine systems with release
  79.      5.0.1 or greater.
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.